home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 2002 November / SGI IRIX Base Documentation 2002 November.iso / usr / share / catman / g_man / cat3 / OpenGL / glteximage3d.z / glteximage3d
Encoding:
Text File  |  2002-10-03  |  49.3 KB  |  535 lines
  1.  
  2.  
  3.  
  4. ggggllllTTTTeeeexxxxIIIImmmmaaaaggggeeee3333DDDD((((3333GGGG))))               OOOOppppeeeennnnGGGGLLLL RRRReeeeffffeeeerrrreeeennnncccceeee               ggggllllTTTTeeeexxxxIIIImmmmaaaaggggeeee3333DDDD((((3333GGGG))))
  5.  
  6.  
  7.  
  8. NNNNAAAAMMMMEEEE
  9.      ggggllllTTTTeeeexxxxIIIImmmmaaaaggggeeee3333DDDD - specify a three-dimensional texture image
  10.  
  11.  
  12. CCCC SSSSPPPPEEEECCCCIIIIFFFFIIIICCCCAAAATTTTIIIIOOOONNNN
  13.      void ggggllllTTTTeeeexxxxIIIImmmmaaaaggggeeee3333DDDD( GLenum _t_a_r_g_e_t,
  14.                         GLint _l_e_v_e_l,
  15.                         GLenum _i_n_t_e_r_n_a_l_f_o_r_m_a_t,
  16.                         GLsizei _w_i_d_t_h,
  17.                         GLsizei _h_e_i_g_h_t,
  18.                         GLsizei _d_e_p_t_h,
  19.                         GLint _b_o_r_d_e_r,
  20.                         GLenum _f_o_r_m_a_t,
  21.                         GLenum _t_y_p_e,
  22.                         const GLvoid *_p_i_x_e_l_s )
  23.  
  24.  
  25. PPPPAAAARRRRAAAAMMMMEEEETTTTEEEERRRRSSSS
  26.      _t_a_r_g_e_t          Specifies the target texture.  Must be GGGGLLLL____TTTTEEEEXXXXTTTTUUUURRRREEEE____3333DDDD or
  27.                      GGGGLLLL____PPPPRRRROOOOXXXXYYYY____TTTTEEEEXXXXTTTTUUUURRRREEEE____3333DDDD.
  28.  
  29.      _l_e_v_e_l           Specifies the level-of-detail number.  Level 0 is the
  30.                                                         th
  31.                      base image level.  Level n is the n   mipmap reduction
  32.                      image.
  33.  
  34.      _i_n_t_e_r_n_a_l_f_o_r_m_a_t  Specifies the number of color components in the texture.
  35.                      Must be 1, 2, 3, or 4, or one of the following symbolic
  36.                      constants:  GGGGLLLL____AAAALLLLPPPPHHHHAAAA, GGGGLLLL____AAAALLLLPPPPHHHHAAAA4444, GGGGLLLL____AAAALLLLPPPPHHHHAAAA8888, GGGGLLLL____AAAALLLLPPPPHHHHAAAA11112222,
  37.                      GGGGLLLL____AAAALLLLPPPPHHHHAAAA11116666, GGGGLLLL____LLLLUUUUMMMMIIIINNNNAAAANNNNCCCCEEEE, GGGGLLLL____LLLLUUUUMMMMIIIINNNNAAAANNNNCCCCEEEE4444, GGGGLLLL____LLLLUUUUMMMMIIIINNNNAAAANNNNCCCCEEEE8888,
  38.                      GGGGLLLL____LLLLUUUUMMMMIIIINNNNAAAANNNNCCCCEEEE11112222, GGGGLLLL____LLLLUUUUMMMMIIIINNNNAAAANNNNCCCCEEEE11116666, GGGGLLLL____LLLLUUUUMMMMIIIINNNNAAAANNNNCCCCEEEE____AAAALLLLPPPPHHHHAAAA,
  39.                      GGGGLLLL____LLLLUUUUMMMMIIIINNNNAAAANNNNCCCCEEEE4444____AAAALLLLPPPPHHHHAAAA4444, GGGGLLLL____LLLLUUUUMMMMIIIINNNNAAAANNNNCCCCEEEE6666____AAAALLLLPPPPHHHHAAAA2222,
  40.                      GGGGLLLL____LLLLUUUUMMMMIIIINNNNAAAANNNNCCCCEEEE8888____AAAALLLLPPPPHHHHAAAA8888, GGGGLLLL____LLLLUUUUMMMMIIIINNNNAAAANNNNCCCCEEEE11112222____AAAALLLLPPPPHHHHAAAA4444,
  41.                      GGGGLLLL____LLLLUUUUMMMMIIIINNNNAAAANNNNCCCCEEEE11112222____AAAALLLLPPPPHHHHAAAA11112222, GGGGLLLL____LLLLUUUUMMMMIIIINNNNAAAANNNNCCCCEEEE11116666____AAAALLLLPPPPHHHHAAAA11116666,
  42.                      GGGGLLLL____IIIINNNNTTTTEEEENNNNSSSSIIIITTTTYYYY, GGGGLLLL____IIIINNNNTTTTEEEENNNNSSSSIIIITTTTYYYY4444, GGGGLLLL____IIIINNNNTTTTEEEENNNNSSSSIIIITTTTYYYY8888,
  43.                      GGGGLLLL____IIIINNNNTTTTEEEENNNNSSSSIIIITTTTYYYY11112222, GGGGLLLL____IIIINNNNTTTTEEEENNNNSSSSIIIITTTTYYYY11116666, GGGGLLLL____RRRR3333____GGGG3333____BBBB2222, GGGGLLLL____RRRRGGGGBBBB,
  44.                      GGGGLLLL____RRRRGGGGBBBB4444, GGGGLLLL____RRRRGGGGBBBB5555, GGGGLLLL____RRRRGGGGBBBB8888, GGGGLLLL____RRRRGGGGBBBB11110000, GGGGLLLL____RRRRGGGGBBBB11112222, GGGGLLLL____RRRRGGGGBBBB11116666,
  45.                      GGGGLLLL____RRRRGGGGBBBBAAAA, GGGGLLLL____RRRRGGGGBBBBAAAA2222, GGGGLLLL____RRRRGGGGBBBBAAAA4444, GGGGLLLL____RRRRGGGGBBBB5555____AAAA1111, GGGGLLLL____RRRRGGGGBBBBAAAA8888,
  46.                      GGGGLLLL____RRRRGGGGBBBB11110000____AAAA2222, GGGGLLLL____RRRRGGGGBBBBAAAA11112222, or GGGGLLLL____RRRRGGGGBBBBAAAA11116666.
  47.  
  48.      _w_i_d_t_h           Specifies the width of the texture image.  Must be
  49.                       n
  50.                      2  + 2(border) for some integer n. All implementations
  51.                      support texture images that are at least 64 texels wide.
  52.  
  53.      _h_e_i_g_h_t          Specifies the height of the texture image.  Must be
  54.                       m
  55.                      2  + 2(border) for some integer m. All implementations
  56.                      support texture images that are at least 64 texels high.
  57.  
  58.      _d_e_p_t_h           Specifies the depth of the texture image.  Must be
  59.                       k
  60.                      2  + 2(border) for some integer k. All implementations
  61.                      support texture images that are at least 64 texels deep.
  62.  
  63.  
  64.  
  65.  
  66.  
  67.                                                                         PPPPaaaaggggeeee 1111
  68.  
  69.  
  70.  
  71.  
  72.  
  73.  
  74. ggggllllTTTTeeeexxxxIIIImmmmaaaaggggeeee3333DDDD((((3333GGGG))))               OOOOppppeeeennnnGGGGLLLL RRRReeeeffffeeeerrrreeeennnncccceeee               ggggllllTTTTeeeexxxxIIIImmmmaaaaggggeeee3333DDDD((((3333GGGG))))
  75.  
  76.  
  77.  
  78.      _b_o_r_d_e_r          Specifies the width of the border.  Must be either 0 or
  79.                      1.
  80.  
  81.      _f_o_r_m_a_t          Specifies the format of the pixel data.  The following
  82.                      symbolic values are accepted:  GGGGLLLL____CCCCOOOOLLLLOOOORRRR____IIIINNNNDDDDEEEEXXXX, GGGGLLLL____RRRREEEEDDDD,
  83.                      GGGGLLLL____GGGGRRRREEEEEEEENNNN, GGGGLLLL____BBBBLLLLUUUUEEEE, GGGGLLLL____AAAALLLLPPPPHHHHAAAA, GGGGLLLL____RRRRGGGGBBBB, GGGGLLLL____BBBBGGGGRRRR, GGGGLLLL____RRRRGGGGBBBBAAAA,
  84.                      GGGGLLLL____BBBBGGGGRRRRAAAA, GGGGLLLL____AAAABBBBGGGGRRRR____EEEEXXXXTTTT, GGGGLLLL____LLLLUUUUMMMMIIIINNNNAAAANNNNCCCCEEEE, and
  85.                      GGGGLLLL____LLLLUUUUMMMMIIIINNNNAAAANNNNCCCCEEEE____AAAALLLLPPPPHHHHAAAA.
  86.  
  87.      _t_y_p_e            Specifies the data type of the pixel data.  The following
  88.                      symbolic values are accepted:  GGGGLLLL____UUUUNNNNSSSSIIIIGGGGNNNNEEEEDDDD____BBBBYYYYTTTTEEEE, GGGGLLLL____BBBBYYYYTTTTEEEE,
  89.                      GGGGLLLL____BBBBIIIITTTTMMMMAAAAPPPP, GGGGLLLL____UUUUNNNNSSSSIIIIGGGGNNNNEEEEDDDD____SSSSHHHHOOOORRRRTTTT, GGGGLLLL____SSSSHHHHOOOORRRRTTTT, GGGGLLLL____UUUUNNNNSSSSIIIIGGGGNNNNEEEEDDDD____IIIINNNNTTTT,
  90.                      GGGGLLLL____IIIINNNNTTTT, GGGGLLLL____FFFFLLLLOOOOAAAATTTT GGGGLLLL____UUUUNNNNSSSSIIIIGGGGNNNNEEEEDDDD____BBBBYYYYTTTTEEEE____3333____3333____2222,
  91.                      GGGGLLLL____UUUUNNNNSSSSIIIIGGGGNNNNEEEEDDDD____BBBBYYYYTTTTEEEE____2222____3333____3333____RRRREEEEVVVV, GGGGLLLL____UUUUNNNNSSSSIIIIGGGGNNNNEEEEDDDD____SSSSHHHHOOOORRRRTTTT____5555____6666____5555,
  92.                      GGGGLLLL____UUUUNNNNSSSSIIIIGGGGNNNNEEEEDDDD____SSSSHHHHOOOORRRRTTTT____5555____6666____5555____RRRREEEEVVVV, GGGGLLLL____UUUUNNNNSSSSIIIIGGGGNNNNEEEEDDDD____SSSSHHHHOOOORRRRTTTT____4444____4444____4444____4444,
  93.                      GGGGLLLL____UUUUNNNNSSSSIIIIGGGGNNNNEEEEDDDD____SSSSHHHHOOOORRRRTTTT____4444____4444____4444____4444____RRRREEEEVVVV, GGGGLLLL____UUUUNNNNSSSSIIIIGGGGNNNNEEEEDDDD____SSSSHHHHOOOORRRRTTTT____5555____5555____5555____1111,
  94.                      GGGGLLLL____UUUUNNNNSSSSIIIIGGGGNNNNEEEEDDDD____SSSSHHHHOOOORRRRTTTT____1111____5555____5555____5555____RRRREEEEVVVV, GGGGLLLL____UUUUNNNNSSSSIIIIGGGGNNNNEEEEDDDD____IIIINNNNTTTT____8888____8888____8888____8888,
  95.                      GGGGLLLL____UUUUNNNNSSSSIIIIGGGGNNNNEEEEDDDD____IIIINNNNTTTT____8888____8888____8888____8888____RRRREEEEVVVV, GGGGLLLL____UUUUNNNNSSSSIIIIGGGGNNNNEEEEDDDD____IIIINNNNTTTT____11110000____11110000____11110000____2222,
  96.                      and GGGGLLLL____UUUUNNNNSSSSIIIIGGGGNNNNEEEEDDDD____IIIINNNNTTTT____2222____11110000____11110000____11110000____RRRREEEEVVVV.
  97.  
  98.      _p_i_x_e_l_s          Specifies a pointer to the image data in memory.
  99.  
  100. DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  101.      Texturing maps a portion of a specified texture image onto each graphical
  102.      primitive for which texturing is enabled.  To enable and disable three-
  103.      dimensional texturing, call ggggllllEEEEnnnnaaaabbbblllleeee and ggggllllDDDDiiiissssaaaabbbblllleeee with argument
  104.      GGGGLLLL____TTTTEEEEXXXXTTTTUUUURRRREEEE____3333DDDD.
  105.  
  106.      To define texture images, call ggggllllTTTTeeeexxxxIIIImmmmaaaaggggeeee3333DDDD. The arguments describe the
  107.      parameters of the texture image, such as height, width, depth, width of
  108.      the border, level-of-detail number (see ggggllllTTTTeeeexxxxPPPPaaaarrrraaaammmmeeeetttteeeerrrr), and number of
  109.      color components provided.  The last three arguments describe how the
  110.      image is represented in memory; they are identical to the pixel formats
  111.      used for ggggllllDDDDrrrraaaawwwwPPPPiiiixxxxeeeellllssss.
  112.  
  113.      If _t_a_r_g_e_t is GGGGLLLL____PPPPRRRROOOOXXXXYYYY____TTTTEEEEXXXXTTTTUUUURRRREEEE____3333DDDD, no data is read from _p_i_x_e_l_s, but all of
  114.      the texture image state is recalculated, checked for consistency, and
  115.      checked against the implementation's capabilities. If the implementation
  116.      cannot handle a texture of the requested texture size, it sets all of the
  117.      image state to 0, but does not generate an error (see ggggllllGGGGeeeettttEEEErrrrrrrroooorrrr). To
  118.      query for an entire mipmap array, use an image array level greater than
  119.      or equal to 1.
  120.  
  121.      If _t_a_r_g_e_t is GGGGLLLL____TTTTEEEEXXXXTTTTUUUURRRREEEE____3333DDDD, data is read from _p_i_x_e_l_s as a sequence of
  122.      signed or unsigned bytes, shorts, or longs, or single-precision
  123.      floating-point values, depending on _t_y_p_e. These values are grouped into
  124.      sets of one, two, three, or four values, depending on _f_o_r_m_a_t, to form
  125.      elements. If _t_y_p_e is GGGGLLLL____BBBBIIIITTTTMMMMAAAAPPPP, the data is considered as a string of
  126.      unsigned bytes (and _f_o_r_m_a_t must be GGGGLLLL____CCCCOOOOLLLLOOOORRRR____IIIINNNNDDDDEEEEXXXX). Each data byte is
  127.      treated as eight 1-bit elements, with bit ordering determined by
  128.      GGGGLLLL____UUUUNNNNPPPPAAAACCCCKKKK____LLLLSSSSBBBB____FFFFIIIIRRRRSSSSTTTT (see ggggllllPPPPiiiixxxxeeeellllSSSSttttoooorrrreeee).
  129.  
  130.  
  131.  
  132.  
  133.                                                                         PPPPaaaaggggeeee 2222
  134.  
  135.  
  136.  
  137.  
  138.  
  139.  
  140. ggggllllTTTTeeeexxxxIIIImmmmaaaaggggeeee3333DDDD((((3333GGGG))))               OOOOppppeeeennnnGGGGLLLL RRRReeeeffffeeeerrrreeeennnncccceeee               ggggllllTTTTeeeexxxxIIIImmmmaaaaggggeeee3333DDDD((((3333GGGG))))
  141.  
  142.  
  143.  
  144.      The first element corresponds to the lower left corner of the texture
  145.      image.  Subsequent elements progress left-to-right through the remaining
  146.      texels in the lowest row of the texture image, and then in successively
  147.      higher rows of the texture image.  The final element corresponds to the
  148.      upper right corner of the texture image.
  149.  
  150.      _f_o_r_m_a_t determines the composition of each element in _p_i_x_e_l_s.  It can
  151.      assume one of eleven symbolic values:
  152.  
  153.      GGGGLLLL____CCCCOOOOLLLLOOOORRRR____IIIINNNNDDDDEEEEXXXX
  154.                Each element is a single value, a color index. The GL converts
  155.                it to fixed point (with an unspecified number of zero bits to
  156.                the right of the binary point), shifted left or right depending
  157.                on the value and sign of GGGGLLLL____IIIINNNNDDDDEEEEXXXX____SSSSHHHHIIIIFFFFTTTT, and added to
  158.                GGGGLLLL____IIIINNNNDDDDEEEEXXXX____OOOOFFFFFFFFSSSSEEEETTTT (see ggggllllPPPPiiiixxxxeeeellllTTTTrrrraaaannnnssssffffeeeerrrr). The resulting index is
  159.                converted to a set of color components using the
  160.                GGGGLLLL____PPPPIIIIXXXXEEEELLLL____MMMMAAAAPPPP____IIII____TTTTOOOO____RRRR, GGGGLLLL____PPPPIIIIXXXXEEEELLLL____MMMMAAAAPPPP____IIII____TTTTOOOO____GGGG, GGGGLLLL____PPPPIIIIXXXXEEEELLLL____MMMMAAAAPPPP____IIII____TTTTOOOO____BBBB,
  161.                and GGGGLLLL____PPPPIIIIXXXXEEEELLLL____MMMMAAAAPPPP____IIII____TTTTOOOO____AAAA tables, and clamped to the range [0,1].
  162.  
  163.      GGGGLLLL____RRRREEEEDDDD    Each element is a single red component. The GL converts it to
  164.                floating point and assembles it into an RGBA element by
  165.                attaching 0 for green and blue, and 1 for alpha. Each component
  166.                is then multiplied by the signed scale factor GGGGLLLL____cccc____SSSSCCCCAAAALLLLEEEE, added
  167.                to the signed bias GGGGLLLL____cccc____BBBBIIIIAAAASSSS, and clamped to the range [0,1]
  168.                (see ggggllllPPPPiiiixxxxeeeellllTTTTrrrraaaannnnssssffffeeeerrrr).
  169.  
  170.      GGGGLLLL____GGGGRRRREEEEEEEENNNN  Each element is a single green component. The GL converts it to
  171.                floating point and assembles it into an RGBA element by
  172.                attaching 0 for red and blue, and 1 for alpha. Each component
  173.                is then multiplied by the signed scale factor GGGGLLLL____cccc____SSSSCCCCAAAALLLLEEEE, added
  174.                to the signed bias GGGGLLLL____cccc____BBBBIIIIAAAASSSS, and clamped to the range [0,1]
  175.                (see ggggllllPPPPiiiixxxxeeeellllTTTTrrrraaaannnnssssffffeeeerrrr).
  176.  
  177.      GGGGLLLL____BBBBLLLLUUUUEEEE   Each element is a single blue component. The GL converts it to
  178.                floating point and assembles it into an RGBA element by
  179.                attaching 0 for red and green, and 1 for alpha. Each component
  180.                is then multiplied by the signed scale factor GGGGLLLL____cccc____SSSSCCCCAAAALLLLEEEE, added
  181.                to the signed bias GGGGLLLL____cccc____BBBBIIIIAAAASSSS, and clamped to the range [0,1]
  182.                (see ggggllllPPPPiiiixxxxeeeellllTTTTrrrraaaannnnssssffffeeeerrrr).
  183.  
  184.      GGGGLLLL____AAAALLLLPPPPHHHHAAAA  Each element is a single alpha component. The GL converts it to
  185.                floating point and assembles it into an RGBA element by
  186.                attaching 0 for red, green, and blue.  Each component is then
  187.                multiplied by the signed scale factor GGGGLLLL____cccc____SSSSCCCCAAAALLLLEEEE, added to the
  188.                signed bias GGGGLLLL____cccc____BBBBIIIIAAAASSSS, and clamped to the range [0,1] (see
  189.                ggggllllPPPPiiiixxxxeeeellllTTTTrrrraaaannnnssssffffeeeerrrr).
  190.  
  191.      GGGGLLLL____RRRRGGGGBBBB
  192.  
  193.      GGGGLLLL____BBBBGGGGRRRR    Each element is an RGB triple.  The GL converts it to floating
  194.                point and assembles it into an RGBA element by attaching 1 for
  195.                alpha.  Each component is then multiplied by the signed scale
  196.  
  197.  
  198.  
  199.                                                                         PPPPaaaaggggeeee 3333
  200.  
  201.  
  202.  
  203.  
  204.  
  205.  
  206. ggggllllTTTTeeeexxxxIIIImmmmaaaaggggeeee3333DDDD((((3333GGGG))))               OOOOppppeeeennnnGGGGLLLL RRRReeeeffffeeeerrrreeeennnncccceeee               ggggllllTTTTeeeexxxxIIIImmmmaaaaggggeeee3333DDDD((((3333GGGG))))
  207.  
  208.  
  209.  
  210.                factor GGGGLLLL____cccc____SSSSCCCCAAAALLLLEEEE, added to the signed bias GGGGLLLL____cccc____BBBBIIIIAAAASSSS, and
  211.                clamped to the range [0,1] (see ggggllllPPPPiiiixxxxeeeellllTTTTrrrraaaannnnssssffffeeeerrrr).
  212.  
  213.      GGGGLLLL____RRRRGGGGBBBBAAAA
  214.  
  215.      GGGGLLLL____BBBBGGGGRRRRAAAA
  216.  
  217.      GGGGLLLL____AAAABBBBGGGGRRRR____EEEEXXXXTTTT
  218.                Each element contains all four components.  Each component is
  219.                multiplied by the signed scale factor GGGGLLLL____cccc____SSSSCCCCAAAALLLLEEEE, added to the
  220.                signed bias GGGGLLLL____cccc____BBBBIIIIAAAASSSS, and clamped to the range [0,1] (see
  221.                ggggllllPPPPiiiixxxxeeeellllTTTTrrrraaaannnnssssffffeeeerrrr).
  222.  
  223.      GGGGLLLL____LLLLUUUUMMMMIIIINNNNAAAANNNNCCCCEEEE
  224.                Each element is a single luminance value.  The GL converts it
  225.                to floating point, then assembles it into an RGBA element by
  226.                replicating the luminance value three times for red, green, and
  227.                blue and attaching 1 for alpha. Each component is then
  228.                multiplied by the signed scale factor GGGGLLLL____cccc____SSSSCCCCAAAALLLLEEEE, added to the
  229.                signed bias GGGGLLLL____cccc____BBBBIIIIAAAASSSS, and clamped to the range [0,1] (see
  230.                ggggllllPPPPiiiixxxxeeeellllTTTTrrrraaaannnnssssffffeeeerrrr).
  231.  
  232.      GGGGLLLL____LLLLUUUUMMMMIIIINNNNAAAANNNNCCCCEEEE____AAAALLLLPPPPHHHHAAAA
  233.                Each element is a luminance/alpha pair.  The GL converts it to
  234.                floating point, then assembles it into an RGBA element by
  235.                replicating the luminance value three times for red, green, and
  236.                blue.  Each component is then multiplied by the signed scale
  237.                factor GGGGLLLL____cccc____SSSSCCCCAAAALLLLEEEE, added to the signed bias GGGGLLLL____cccc____BBBBIIIIAAAASSSS, and
  238.                clamped to the range [0,1] (see ggggllllPPPPiiiixxxxeeeellllTTTTrrrraaaannnnssssffffeeeerrrr).
  239.  
  240.      Refer to the ggggllllDDDDrrrraaaawwwwPPPPiiiixxxxeeeellllssss reference page for a description of the
  241.      acceptable values for the _t_y_p_e parameter.
  242.  
  243.      If an application wants to store the texture at a certain resolution or
  244.      in a certain format, it can request the resolution and format with
  245.      _i_n_t_e_r_n_a_l_f_o_r_m_a_t. The GL will choose an internal representation that
  246.      closely approximates that requested by _i_n_t_e_r_n_a_l_f_o_r_m_a_t, but it may not
  247.      match exactly.  (The representations specified by GGGGLLLL____LLLLUUUUMMMMIIIINNNNAAAANNNNCCCCEEEE,
  248.      GGGGLLLL____LLLLUUUUMMMMIIIINNNNAAAANNNNCCCCEEEE____AAAALLLLPPPPHHHHAAAA, GGGGLLLL____RRRRGGGGBBBB, and GGGGLLLL____RRRRGGGGBBBBAAAA must match exactly. The numeric
  249.      values 1, 2, 3, and 4 may also be used to specify the above
  250.      representations.)
  251.  
  252.      Use the GGGGLLLL____PPPPRRRROOOOXXXXYYYY____TTTTEEEEXXXXTTTTUUUURRRREEEE____3333DDDD target to try out a resolution and format.
  253.      The implementation will update and recompute its best match for the
  254.      requested storage resolution and format. To then query this state, call
  255.      ggggllllGGGGeeeettttTTTTeeeexxxxLLLLeeeevvvveeeellllPPPPaaaarrrraaaammmmeeeetttteeeerrrr.  If the texture cannot be accommodated, texture
  256.      state is set to 0.
  257.  
  258.      A one-component texture image uses only the red component of the RGBA
  259.      color extracted from _p_i_x_e_l_s. A two-component image uses the R and A
  260.      values.  A three-component image uses the R, G, and B values.  A four-
  261.      component image uses all of the RGBA components.
  262.  
  263.  
  264.  
  265.                                                                         PPPPaaaaggggeeee 4444
  266.  
  267.  
  268.  
  269.  
  270.  
  271.  
  272. ggggllllTTTTeeeexxxxIIIImmmmaaaaggggeeee3333DDDD((((3333GGGG))))               OOOOppppeeeennnnGGGGLLLL RRRReeeeffffeeeerrrreeeennnncccceeee               ggggllllTTTTeeeexxxxIIIImmmmaaaaggggeeee3333DDDD((((3333GGGG))))
  273.  
  274.  
  275.  
  276.      Normally ggggllllTTTTeeeexxxxIIIImmmmaaaaggggeeee3333DDDD is synchronous: OpenGL executes a ggggllllTTTTeeeexxxxIIIImmmmaaaaggggeeee3333DDDD
  277.      command in the order it is issued in the OpenGL command stream.  Calling
  278.      ggggllllEEEEnnnnaaaabbbblllleeee with parameter GGGGLLLL____AAAASSSSYYYYNNNNCCCC____TTTTEEEEXXXX____IIIIMMMMAAAAGGGGEEEE____SSSSGGGGIIIIXXXX causes subsequent
  279.      ggggllllTTTTeeeexxxxIIIImmmmaaaaggggeeee3333DDDD commands to be asynchronous as defined by the SSSSGGGGIIIIXXXX____aaaassssyyyynnnncccc
  280.      extension.  An asynchronous ggggllllTTTTeeeexxxxIIIImmmmaaaaggggeeee3333DDDD command samples the OpenGL state
  281.      vector at the point in the OpenGL command stream where the command is
  282.      issued, but the results of the command (e.g. availability of texels for
  283.      use in rasterization) do not happen until some unspecified time in the
  284.      future.  In particular, the order of the asynchronous command relative to
  285.      other OpenGL commands issued later in the command stream is undefined.
  286.      An implementation may choose to execute asynchronous commands in parallel
  287.      with the normal command stream or at some convenient time in the future.
  288.  
  289.      Calling ggggllllDDDDiiiissssaaaabbbblllleeee with parameter GGGGLLLL____AAAASSSSYYYYNNNNCCCC____TTTTEEEEXXXX____IIIIMMMMAAAAGGGGEEEE____SSSSGGGGIIIIXXXX restores the
  290.      default synchronous behavior for subsequent ggggllllTTTTeeeexxxxIIIImmmmaaaaggggeeee3333DDDD commands.  It
  291.      does not affect any pending asynchronous ggggllllTTTTeeeexxxxIIIImmmmaaaaggggeeee commands, or wait for
  292.      their completion.
  293.  
  294.      When an asynchronous ggggllllTTTTeeeexxxxIIIImmmmaaaaggggeeee3333DDDD command is issued, it is associated
  295.      with the current value of GGGGLLLL____AAAASSSSYYYYNNNNCCCC____MMMMAAAARRRRKKKKEEEERRRR____SSSSGGGGIIIIXXXX as defined by the
  296.      SSSSGGGGIIIIXXXX____aaaassssyyyynnnncccc extension.  A program can determine if an asynchronous
  297.      ggggllllTTTTeeeexxxxIIIImmmmaaaaggggeeee3333DDDD command has completed by using the ggggllllFFFFiiiinnnniiiisssshhhhAAAAssssyyyynnnnccccSSSSGGGGIIIIXXXX or
  298.      ggggllllPPPPoooollllllllAAAAssssyyyynnnnccccSSSSGGGGIIIIXXXX commands.
  299.  
  300.      There is a maximum number of asynchronous ggggllllTTTTeeeexxxxIIIImmmmaaaaggggeeee commands that can be
  301.      outstanding at any one time, defined by the implementation.  This value
  302.      can be queried with ggggllllGGGGeeeettttIIIInnnntttteeeeggggeeeerrrrvvvv with argument
  303.      GGGGLLLL____MMMMAAAAXXXX____AAAASSSSYYYYNNNNCCCC____TTTTEEEEXXXX____IIIIMMMMAAAAGGGGEEEE____SSSSGGGGIIIIXXXX.
  304.  
  305. NNNNOOOOTTTTEEEESSSS
  306.      Texturing has no effect in color index mode.
  307.  
  308.      The texture image can be represented by the same data formats as the
  309.      pixels in a ggggllllDDDDrrrraaaawwwwPPPPiiiixxxxeeeellllssss command, except that GGGGLLLL____SSSSTTTTEEEENNNNCCCCIIIILLLL____IIIINNNNDDDDEEEEXXXX and
  310.      GGGGLLLL____DDDDEEEEPPPPTTTTHHHH____CCCCOOOOMMMMPPPPOOOONNNNEEEENNNNTTTT cannot be used.  ggggllllPPPPiiiixxxxeeeellllSSSSttttoooorrrreeee and ggggllllPPPPiiiixxxxeeeellllTTTTrrrraaaannnnssssffffeeeerrrr
  311.      modes affect texture images in exactly the way they affect ggggllllDDDDrrrraaaawwwwPPPPiiiixxxxeeeellllssss.
  312.  
  313.      GGGGLLLL____AAAABBBBGGGGRRRR____EEEEXXXXTTTT is part of the EEEEXXXXTTTT____aaaabbbbggggrrrr extension, not part of the core GL
  314.      command set.  If GGGGLLLL____EEEEXXXXTTTT____aaaabbbbggggrrrr is included in the string returned by
  315.      ggggllllGGGGeeeettttSSSSttttrrrriiiinnnngggg, when called with argument GGGGLLLL____EEEEXXXXTTTTEEEENNNNSSSSIIIIOOOONNNNSSSS, extension EEEEXXXXTTTT____aaaabbbbggggrrrr
  316.      is supported by the GL.
  317.  
  318.      ggggllllTTTTeeeexxxxIIIImmmmaaaaggggeeee3333DDDD is available only if the GL version is 1.2 or greater.
  319.  
  320.      Internal formats other than 1, 2, 3, or 4 may be used only if the GL
  321.      version is 1.1 or greater.
  322.  
  323.      _p_i_x_e_l_s may be a null pointer. In this case texture memory is allocated to
  324.      accommodate a texture of width _w_i_d_t_h, height _h_e_i_g_h_t, and depth _d_e_p_t_h.
  325.      You can then download subtextures to initialize this texture memory. The
  326.      image is undefined if the user tries to apply an uninitialized portion of
  327.      the texture image to a primitive.
  328.  
  329.  
  330.  
  331.                                                                         PPPPaaaaggggeeee 5555
  332.  
  333.  
  334.  
  335.  
  336.  
  337.  
  338. ggggllllTTTTeeeexxxxIIIImmmmaaaaggggeeee3333DDDD((((3333GGGG))))               OOOOppppeeeennnnGGGGLLLL RRRReeeeffffeeeerrrreeeennnncccceeee               ggggllllTTTTeeeexxxxIIIImmmmaaaaggggeeee3333DDDD((((3333GGGG))))
  339.  
  340.  
  341.  
  342.      Formats GGGGLLLL____BBBBGGGGRRRR, and GGGGLLLL____BBBBGGGGRRRRAAAA and types GGGGLLLL____UUUUNNNNSSSSIIIIGGGGNNNNEEEEDDDD____BBBBYYYYTTTTEEEE____3333____3333____2222,
  343.      GGGGLLLL____UUUUNNNNSSSSIIIIGGGGNNNNEEEEDDDD____BBBBYYYYTTTTEEEE____2222____3333____3333____RRRREEEEVVVV, GGGGLLLL____UUUUNNNNSSSSIIIIGGGGNNNNEEEEDDDD____SSSSHHHHOOOORRRRTTTT____5555____6666____5555,
  344.      GGGGLLLL____UUUUNNNNSSSSIIIIGGGGNNNNEEEEDDDD____SSSSHHHHOOOORRRRTTTT____5555____6666____5555____RRRREEEEVVVV, GGGGLLLL____UUUUNNNNSSSSIIIIGGGGNNNNEEEEDDDD____SSSSHHHHOOOORRRRTTTT____4444____4444____4444____4444,
  345.      GGGGLLLL____UUUUNNNNSSSSIIIIGGGGNNNNEEEEDDDD____SSSSHHHHOOOORRRRTTTT____4444____4444____4444____4444____RRRREEEEVVVV, GGGGLLLL____UUUUNNNNSSSSIIIIGGGGNNNNEEEEDDDD____SSSSHHHHOOOORRRRTTTT____5555____5555____5555____1111,
  346.      GGGGLLLL____UUUUNNNNSSSSIIIIGGGGNNNNEEEEDDDD____SSSSHHHHOOOORRRRTTTT____1111____5555____5555____5555____RRRREEEEVVVV, GGGGLLLL____UUUUNNNNSSSSIIIIGGGGNNNNEEEEDDDD____IIIINNNNTTTT____8888____8888____8888____8888,
  347.      GGGGLLLL____UUUUNNNNSSSSIIIIGGGGNNNNEEEEDDDD____IIIINNNNTTTT____8888____8888____8888____8888____RRRREEEEVVVV, GGGGLLLL____UUUUNNNNSSSSIIIIGGGGNNNNEEEEDDDD____IIIINNNNTTTT____11110000____11110000____11110000____2222, and
  348.      GGGGLLLL____UUUUNNNNSSSSIIIIGGGGNNNNEEEEDDDD____IIIINNNNTTTT____2222____11110000____11110000____11110000____RRRREEEEVVVV are available only if the GL version is
  349.      1.2 or greater.
  350.  
  351.      If the GGGGLLLL____AAAARRRRBBBB____iiiimmmmaaaaggggiiiinnnngggg extension is supported, RGBA elements may also be
  352.      processed by the imaging pipeline.  The following stages may be applied
  353.      to an RGBA color before color component clamping to the range [0, 1]:
  354.  
  355.      1. Color component replacement by the color table specified for
  356.         GGGGLLLL____CCCCOOOOLLLLOOOORRRR____TTTTAAAABBBBLLLLEEEE, if enabled. See ggggllllCCCCoooolllloooorrrrTTTTaaaabbbblllleeee.
  357.  
  358.      2. Color component replacement by the color table specified for
  359.         GGGGLLLL____PPPPOOOOSSSSTTTT____CCCCOOOONNNNVVVVOOOOLLLLUUUUTTTTIIIIOOOONNNN____CCCCOOOOLLLLOOOORRRR____TTTTAAAABBBBLLLLEEEE, if enabled.  See ggggllllCCCCoooolllloooorrrrTTTTaaaabbbblllleeee.
  360.  
  361.      3. Transformation by the color matrix.  See ggggllllMMMMaaaattttrrrriiiixxxxMMMMooooddddeeee.
  362.  
  363.      4. RGBA components may be multiplied by GGGGLLLL____PPPPOOOOSSSSTTTT____CCCCOOOOLLLLOOOORRRR____MMMMAAAATTTTRRRRIIIIXXXX____cccc____SSSSCCCCAAAALLLLEEEE,
  364.         and added to GGGGLLLL____PPPPOOOOSSSSTTTT____CCCCOOOOLLLLOOOORRRR____MMMMAAAATTTTRRRRIIIIXXXX____cccc____BBBBIIIIAAAASSSS, if enabled.  See
  365.         ggggllllPPPPiiiixxxxeeeellllTTTTrrrraaaannnnssssffffeeeerrrr.
  366.  
  367.      5. Color component replacement by the color table specified for
  368.         GGGGLLLL____PPPPOOOOSSSSTTTT____CCCCOOOOLLLLOOOORRRR____MMMMAAAATTTTRRRRIIIIXXXX____CCCCOOOOLLLLOOOORRRR____TTTTAAAABBBBLLLLEEEE, if enabled.  See ggggllllCCCCoooolllloooorrrrTTTTaaaabbbblllleeee.
  369.  
  370. EEEERRRRRRRROOOORRRRSSSS
  371.      GGGGLLLL____IIIINNNNVVVVAAAALLLLIIIIDDDD____EEEENNNNUUUUMMMM is generated if _t_a_r_g_e_t is not GGGGLLLL____TTTTEEEEXXXXTTTTUUUURRRREEEE____3333DDDD or
  372.      GGGGLLLL____PPPPRRRROOOOXXXXYYYY____TTTTEEEEXXXXTTTTUUUURRRREEEE____3333DDDD.
  373.  
  374.      GGGGLLLL____IIIINNNNVVVVAAAALLLLIIIIDDDD____EEEENNNNUUUUMMMM is generated if _f_o_r_m_a_t is not an accepted format
  375.      constant.  Format constants other than GGGGLLLL____SSSSTTTTEEEENNNNCCCCIIIILLLL____IIIINNNNDDDDEEEEXXXX and
  376.      GGGGLLLL____DDDDEEEEPPPPTTTTHHHH____CCCCOOOOMMMMPPPPOOOONNNNEEEENNNNTTTT are accepted.
  377.  
  378.      GGGGLLLL____IIIINNNNVVVVAAAALLLLIIIIDDDD____EEEENNNNUUUUMMMM is generated if _t_y_p_e is not a type constant.
  379.  
  380.      GGGGLLLL____IIIINNNNVVVVAAAALLLLIIIIDDDD____EEEENNNNUUUUMMMM is generated if _t_y_p_e is GGGGLLLL____BBBBIIIITTTTMMMMAAAAPPPP and _f_o_r_m_a_t is not
  381.      GGGGLLLL____CCCCOOOOLLLLOOOORRRR____IIIINNNNDDDDEEEEXXXX.
  382.  
  383.      GGGGLLLL____IIIINNNNVVVVAAAALLLLIIIIDDDD____VVVVAAAALLLLUUUUEEEE is generated if _l_e_v_e_l is less than 0.
  384.  
  385.      GGGGLLLL____IIIINNNNVVVVAAAALLLLIIIIDDDD____VVVVAAAALLLLUUUUEEEE may be generated if _l_e_v_e_l is greater than log _m_a_x, where
  386.                                                                    2
  387.      _m_a_x is the returned value of GGGGLLLL____MMMMAAAAXXXX____TTTTEEEEXXXXTTTTUUUURRRREEEE____SSSSIIIIZZZZEEEE.
  388.  
  389.      GGGGLLLL____IIIINNNNVVVVAAAALLLLIIIIDDDD____VVVVAAAALLLLUUUUEEEE is generated if _i_n_t_e_r_n_a_l_f_o_r_m_a_t is not 1, 2, 3, 4, or one
  390.      of the accepted resolution and format symbolic constants.
  391.  
  392.      GGGGLLLL____IIIINNNNVVVVAAAALLLLIIIIDDDD____VVVVAAAALLLLUUUUEEEE is generated if _w_i_d_t_h, _h_e_i_g_h_t, or _d_e_p_t_h is less than 0
  393.      or greater than 2 + GGGGLLLL____MMMMAAAAXXXX____TTTTEEEEXXXXTTTTUUUURRRREEEE____SSSSIIIIZZZZEEEE, or if either cannot be
  394.                      k
  395.      represented as 2  + 2(border) for some integer value of _k.
  396.  
  397.  
  398.  
  399.                                                                         PPPPaaaaggggeeee 6666
  400.  
  401.  
  402.  
  403.  
  404.  
  405.  
  406. ggggllllTTTTeeeexxxxIIIImmmmaaaaggggeeee3333DDDD((((3333GGGG))))               OOOOppppeeeennnnGGGGLLLL RRRReeeeffffeeeerrrreeeennnncccceeee               ggggllllTTTTeeeexxxxIIIImmmmaaaaggggeeee3333DDDD((((3333GGGG))))
  407.  
  408.  
  409.  
  410.      GGGGLLLL____IIIINNNNVVVVAAAALLLLIIIIDDDD____VVVVAAAALLLLUUUUEEEE is generated if _b_o_r_d_e_r is not 0 or 1.
  411.  
  412.      GGGGLLLL____IIIINNNNVVVVAAAALLLLIIIIDDDD____OOOOPPPPEEEERRRRAAAATTTTIIIIOOOONNNN is generated if ggggllllTTTTeeeexxxxIIIImmmmaaaaggggeeee3333DDDD is executed between the
  413.      execution of ggggllllBBBBeeeeggggiiiinnnn and the corresponding execution of ggggllllEEEEnnnndddd.
  414.  
  415.      GGGGLLLL____IIIINNNNVVVVAAAALLLLIIIIDDDD____OOOOPPPPEEEERRRRAAAATTTTIIIIOOOONNNN is generated if _t_y_p_e is one of
  416.      GGGGLLLL____UUUUNNNNSSSSIIIIGGGGNNNNEEEEDDDD____BBBBYYYYTTTTEEEE____3333____3333____2222, GGGGLLLL____UUUUNNNNSSSSIIIIGGGGNNNNEEEEDDDD____BBBBYYYYTTTTEEEE____2222____3333____3333____RRRREEEEVVVV,
  417.      GGGGLLLL____UUUUNNNNSSSSIIIIGGGGNNNNEEEEDDDD____SSSSHHHHOOOORRRRTTTT____5555____6666____5555, or GGGGLLLL____UUUUNNNNSSSSIIIIGGGGNNNNEEEEDDDD____SSSSHHHHOOOORRRRTTTT____5555____6666____5555____RRRREEEEVVVV and _f_o_r_m_a_t is not
  418.      GGGGLLLL____RRRRGGGGBBBB.
  419.  
  420.      GGGGLLLL____IIIINNNNVVVVAAAALLLLIIIIDDDD____OOOOPPPPEEEERRRRAAAATTTTIIIIOOOONNNN is generated if _t_y_p_e is one of
  421.      GGGGLLLL____UUUUNNNNSSSSIIIIGGGGNNNNEEEEDDDD____SSSSHHHHOOOORRRRTTTT____4444____4444____4444____4444, GGGGLLLL____UUUUNNNNSSSSIIIIGGGGNNNNEEEEDDDD____SSSSHHHHOOOORRRRTTTT____4444____4444____4444____4444____RRRREEEEVVVV,
  422.      GGGGLLLL____UUUUNNNNSSSSIIIIGGGGNNNNEEEEDDDD____SSSSHHHHOOOORRRRTTTT____5555____5555____5555____1111, GGGGLLLL____UUUUNNNNSSSSIIIIGGGGNNNNEEEEDDDD____SSSSHHHHOOOORRRRTTTT____1111____5555____5555____5555____RRRREEEEVVVV,
  423.      GGGGLLLL____UUUUNNNNSSSSIIIIGGGGNNNNEEEEDDDD____IIIINNNNTTTT____8888____8888____8888____8888, GGGGLLLL____UUUUNNNNSSSSIIIIGGGGNNNNEEEEDDDD____IIIINNNNTTTT____8888____8888____8888____8888____RRRREEEEVVVV,
  424.      GGGGLLLL____UUUUNNNNSSSSIIIIGGGGNNNNEEEEDDDD____IIIINNNNTTTT____11110000____11110000____11110000____2222, or GGGGLLLL____UUUUNNNNSSSSIIIIGGGGNNNNEEEEDDDD____IIIINNNNTTTT____2222____11110000____11110000____11110000____RRRREEEEVVVV and _f_o_r_m_a_t
  425.      is not GGGGLLLL____RRRRGGGGBBBBAAAA, GGGGLLLL____BBBBGGGGRRRRAAAA or GGGGLLLL____AAAABBBBGGGGRRRR____EEEEXXXXTTTT.
  426.  
  427.      GGGGLLLL____IIIINNNNVVVVAAAALLLLIIIIDDDD____OOOOPPPPEEEERRRRAAAATTTTIIIIOOOONNNN is generated if GGGGLLLL____AAAASSSSYYYYNNNNCCCC____TTTTEEEEXXXX____IIIIMMMMAAAAGGGGEEEE____SSSSGGGGIIIIXXXX is enabled
  428.      and the number of asynchronous ggggllllTTTTeeeexxxxIIIImmmmaaaaggggeeee commands that have been issued
  429.      but not queried (using ggggllllFFFFiiiinnnniiiisssshhhhAAAAssssyyyynnnnccccSSSSGGGGIIIIXXXX or ggggllllPPPPoooollllllllAAAAssssyyyynnnnccccSSSSGGGGIIIIXXXX) exceeds
  430.      GGGGLLLL____MMMMAAAAXXXX____AAAASSSSYYYYNNNNCCCC____TTTTEEEEXXXX____IIIIMMMMAAAAGGGGEEEE____SSSSGGGGIIIIXXXX.
  431.  
  432. AAAASSSSSSSSOOOOCCCCIIIIAAAATTTTEEEEDDDD GGGGEEEETTTTSSSS
  433.      ggggllllGGGGeeeettttTTTTeeeexxxxIIIImmmmaaaaggggeeee
  434.      ggggllllIIIIssssEEEEnnnnaaaabbbblllleeeedddd with argument GGGGLLLL____TTTTEEEEXXXXTTTTUUUURRRREEEE____3333DDDD
  435.  
  436.  
  437. MMMMAAAACCCCHHHHIIIINNNNEEEE DDDDEEEEPPPPEEEENNNNDDDDEEEENNNNCCCCIIIIEEEESSSS
  438.      The SSSSGGGGIIIIXXXX____aaaassssyyyynnnncccc and SSSSGGGGIIIIXXXX____aaaassssyyyynnnncccc____ppppiiiixxxxeeeellll extensions are implemented only on
  439.      OOOOccccttttaaaannnneeee2222 VVVVPPPPrrrroooo systems.
  440.  
  441.      On RRRReeeeaaaalllliiiittttyyyyEEEEnnnnggggiiiinnnneeee, RRRReeeeaaaalllliiiittttyyyyEEEEnnnnggggiiiinnnneeee2222, and VVVVTTTTXXXX systems, the following
  442.      restrictions apply to 3D texturing:
  443.  
  444.           1.  The texture environment must be defined and texturing must be
  445.               enabled before loading a texture.
  446.  
  447.           2.  Texture formats composed only of alpha are not supported.
  448.  
  449.           3.  Borders are not supported; hence the border width must be 0.
  450.  
  451.           4.  Proxy textures are not supported.
  452.  
  453.           5.  3D mipmaps are not supported. Hence, the minifying function must
  454.               be set to GGGGLLLL____NNNNEEEEAAAARRRREEEESSSSTTTT or GGGGLLLL____LLLLIIIINNNNEEEEAAAARRRR (see ggggllllTTTTeeeexxxxPPPPaaaarrrraaaammmmeeeetttteeeerrrr).
  455.  
  456.           6   3D texturing when rendering to pixmaps is not supported.
  457.  
  458.           7.  GGGGLLLL____IIIINNNNTTTTEEEERRRRLLLLAAAACCCCEEEE____SSSSGGGGIIIIXXXX is not supported (see ggggllllEEEEnnnnaaaabbbblllleeee).
  459.  
  460.  
  461.  
  462.  
  463.  
  464.  
  465.                                                                         PPPPaaaaggggeeee 7777
  466.  
  467.  
  468.  
  469.  
  470.  
  471.  
  472. ggggllllTTTTeeeexxxxIIIImmmmaaaaggggeeee3333DDDD((((3333GGGG))))               OOOOppppeeeennnnGGGGLLLL RRRReeeeffffeeeerrrreeeennnncccceeee               ggggllllTTTTeeeexxxxIIIImmmmaaaaggggeeee3333DDDD((((3333GGGG))))
  473.  
  474.  
  475.  
  476.      On HHHHiiiigggghhhh IIIImmmmppppaaaacccctttt and MMMMaaaaxxxxiiiimmmmuuuummmm IIIImmmmppppaaaacccctttt systems, the following restrictions
  477.      apply to 3D texturing:
  478.  
  479.           1.  Perspective views are not supported.
  480.  
  481.           2.  Borders are not supported; hence the border width must be 0.
  482.  
  483.           3.  3D mipmaps are not supported. Hence, the minifying function must
  484.               be set to GGGGLLLL____NNNNEEEEAAAARRRREEEESSSSTTTT or GGGGLLLL____LLLLIIIINNNNEEEEAAAARRRR (see ggggllllTTTTeeeexxxxPPPPaaaarrrraaaammmmeeeetttteeeerrrr), and the
  485.               level parameter must be 0.
  486.  
  487.           4.  Textures that have a width of 16 or less will not render
  488.               correctly at the wrap_s boundary.
  489.      On OOOOccccttttaaaannnneeee2222 VVVVPPPPrrrroooo systems, 3D mipmapping is not supported.  However, all
  490.      OpenGL state related to the GGGGLLLL____TTTTEEEEXXXXTTTTUUUURRRREEEE____3333DDDD target is correctly error-
  491.      checked and queryable.  For example, an incomplete mipmap stack results
  492.      in disabling 3D texturing, just as if 3D mipmapping were supported.  The
  493.      only restriction is that, during rasterization, only the base level of
  494.      the texture is sampled.  (The GGGGLLLL____TTTTEEEEXXXXTTTTUUUURRRREEEE____BBBBAAAASSSSEEEE____LLLLEEEEVVVVEEEELLLL parameter may be used
  495.      to establish the base level of the texture; it need not be level 0.)  For
  496.      3D texturing at rasterization time, the mipmapping forms of the
  497.      GGGGLLLL____TTTTEEEEXXXXTTTTUUUURRRREEEE____MMMMIIIINNNN____FFFFIIIILLLLTTTTEEEERRRR parameter are synonymous with the equivalent non-
  498.      mipmapping form.
  499.  
  500.  
  501. SSSSEEEEEEEE AAAALLLLSSSSOOOO
  502.      ggggllllCCCCooooppppyyyyPPPPiiiixxxxeeeellllssss, ggggllllCCCCooooppppyyyyTTTTeeeexxxxIIIImmmmaaaaggggeeee1111DDDD, ggggllllCCCCooooppppyyyyTTTTeeeexxxxIIIImmmmaaaaggggeeee2222DDDD, ggggllllCCCCooooppppyyyyTTTTeeeexxxxSSSSuuuubbbbIIIImmmmaaaaggggeeee1111DDDD,
  503.      ggggllllCCCCooooppppyyyyTTTTeeeexxxxSSSSuuuubbbbIIIImmmmaaaaggggeeee2222DDDD, ggggllllCCCCooooppppyyyyTTTTeeeexxxxSSSSuuuubbbbIIIImmmmaaaaggggeeee3333DDDD, ggggllllDDDDrrrraaaawwwwPPPPiiiixxxxeeeellllssss, ggggllllPPPPiiiixxxxeeeellllSSSSttttoooorrrreeee,
  504.      ggggllllPPPPiiiixxxxeeeellllTTTTrrrraaaannnnssssffffeeeerrrr, ggggllllTTTTeeeexxxxEEEEnnnnvvvv, ggggllllTTTTeeeexxxxGGGGeeeennnn, ggggllllTTTTeeeexxxxIIIImmmmaaaaggggeeee1111DDDD, ggggllllTTTTeeeexxxxIIIImmmmaaaaggggeeee2222DDDD,
  505.      ggggllllTTTTeeeexxxxSSSSuuuubbbbIIIImmmmaaaaggggeeee1111DDDD, ggggllllTTTTeeeexxxxSSSSuuuubbbbIIIImmmmaaaaggggeeee2222DDDD, ggggllllTTTTeeeexxxxSSSSuuuubbbbIIIImmmmaaaaggggeeee3333DDDD, ggggllllTTTTeeeexxxxPPPPaaaarrrraaaammmmeeeetttteeeerrrr,
  506.      ggggllllAAAAssssyyyynnnnccccMMMMaaaarrrrkkkkeeeerrrrSSSSGGGGIIIIXXXX, ggggllllDDDDeeeelllleeeetttteeeeAAAAssssyyyynnnnccccMMMMaaaarrrrkkkkeeeerrrrssssSSSSGGGGIIIIXXXX, ggggllllFFFFiiiinnnniiiisssshhhhAAAAssssyyyynnnnccccSSSSGGGGIIIIXXXX,
  507.      ggggllllGGGGeeeennnnAAAAssssyyyynnnnccccMMMMaaaarrrrkkkkeeeerrrrssssSSSSGGGGIIIIXXXX, ggggllllIIIIssssAAAAssssyyyynnnnccccMMMMaaaarrrrkkkkeeeerrrrSSSSGGGGIIIIXXXX, ggggllllPPPPoooollllllllAAAAssssyyyynnnnccccSSSSGGGGIIIIXXXX
  508.  
  509.  
  510.  
  511.  
  512.  
  513.  
  514.  
  515.  
  516.  
  517.  
  518.  
  519.  
  520.  
  521.  
  522.  
  523.  
  524.  
  525.  
  526.  
  527.  
  528.  
  529.  
  530.  
  531.                                                                         PPPPaaaaggggeeee 8888
  532.  
  533.  
  534.  
  535.